home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / a_man / cat1 / sysctlrd.z / sysctlrd
Encoding:
Text File  |  2001-04-17  |  9.0 KB  |  199 lines
  1.  
  2.  
  3.  
  4. ssssyyyyssssccccttttllllrrrrdddd((((1111MMMM))))                                                      ssssyyyyssssccccttttllllrrrrdddd((((1111MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      sysctlrd - communicates with the system controller and LCD front panel on
  10.      Onyx/Challenge L/XL systems
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ////uuuussssrrrr////eeeettttcccc////ssssyyyyssssccccttttllllrrrrdddd ----dddd [ ----gggg ] [ ----nnnn ] [ ----vvvv ] | ----pppp
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      _s_y_s_c_t_l_r_d can be run as a user command or as a daemon run by
  17.      /_e_t_c/_r_c_2._d/_S_3_3_s_y_s_c_t_l_r.  It handles all necessary communications with an
  18.      Onyx or Challenge L/XL system's system controller, which controls power
  19.      sequencing and fan speed, monitors system sensors, and drives the LCD
  20.      front panel.  _s_y_s_c_t_l_r_d runs the cpu activity histogram on the front
  21.      panel, retrieves environmental sensor data, and handles warning and alarm
  22.      messages from the system controller.  _s_y_s_c_t_l_r_d also logs configuration
  23.      error messages from the PROM in /_v_a_r/_a_d_m/_S_Y_S_L_O_G (see _s_y_s_l_o_g(3C)).
  24.  
  25.      The options are:
  26.  
  27.      ----dddd   Daemon mode.  Only one _s_y_s_c_t_l_r_d can run as a daemon at a time, and
  28.           it must be run as root.
  29.  
  30.      ----gggg   Graceful powerdown mode (only works with ----dddd).  _s_y_s_c_t_l_r_d sends a
  31.           hang-up signal to all processes, waits two seconds, sends a kill
  32.           signal to all processes, syncs all disks, and then powers the system
  33.           down.
  34.  
  35.      ----nnnn   No CPU meter mode (only works with ----dddd).  Keeps _s_y_s_c_t_l_r_d from sending
  36.           CPU performance information to the LCD front panel.
  37.  
  38.      ----vvvv   Give more verbose output.
  39.  
  40.      ----llll   Logging of VDC extrema changes from all of the power supplies when
  41.           run in VDC variance logging mode. (e.g. the "-l" option is passed to
  42.           sysctlrd from /etc/init.d/sysctlr). This is useful if you are
  43.           collecting lots of information to debug and/or analyze a problem
  44.           which you believe may be related to power surges and/or hardware
  45.           failures. Please contact SGI technical support in the event that
  46.           there is some problem which you believe needs their attention.
  47.  
  48.      ----pppp   Print sensor information (does not work with ----dddd).  This option
  49.           causes _s_y_s_c_t_l_r_d to query the daemon for system controller sensor
  50.           information and print it in a human-readable format.
  51.  
  52. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  53.      "*** ..." messages are PROM configuration messages logged by _s_y_s_c_t_l_r_d.
  54.  
  55.      Messages of the form "Event: date time: ..." are retrieved directly from
  56.      system controller log RAM.  These may hold information about when and why
  57.      the system was shut down previously.  Note that the times listed are from
  58.      the system controller's internal clock.  This clock is set at each
  59.      invocation of _s_y_s_c_t_l_r_d with the ----dddd option, and it runs freely from then
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ssssyyyyssssccccttttllllrrrrdddd((((1111MMMM))))                                                      ssssyyyyssssccccttttllllrrrrdddd((((1111MMMM))))
  71.  
  72.  
  73.  
  74.      on.  The clock has no concept of alternate timezones.  Some examples of
  75.      informational messages that may be logged are:
  76.  
  77.      SSSSCCCCLLLLRRRR DDDDEEEETTTTEEEECCCCTTTTEEEEDDDD   The system was reset from the front panel or rebooted via
  78.                      a UNIX command.
  79.  
  80.      SSSSYYYYSSSSTTTTEEEEMMMM OOOOFFFFFFFF      The system was powered-off from the front panel.
  81.  
  82.      SSSSYYYYSSSSTTTTEEEEMMMM OOOONNNN       The system was powered-on from the front panel.
  83.  
  84.      NNNNMMMMIIII             Someone selected NMI (nonmaskable interrupt) from the
  85.                      front panel.
  86.  
  87.      "Couldn't open /dev/sysctlr. Exiting" is printed to standard error if the
  88.      daemon cannot open the system controller device driver.  It usually means
  89.      that a daemon is already running.
  90.  
  91.      "Get env info failed" is logged if _s_y_s_c_t_l_r_d is unable to get the sensor
  92.      information after retries.
  93.  
  94.      "Get scale failed!  Assuming small panel" is logged if _s_y_s_c_t_l_r_d cannot
  95.      get the LCD panel size.  On Onyx/Challenge XL systems, this results in
  96.      very short CPU performance bars since they are improperly scaled.
  97.  
  98.      "Get log failed!" is logged if _s_y_s_c_t_l_r_d cannot retrieve the system
  99.      controller event log containing such events as system resets, power
  100.      fails, voltage problems, overheating, and so on.
  101.  
  102.      "Can't contact daemon. Exiting" is printed to standard error if a non-
  103.      daemon invocation of _s_y_s_c_t_l_r_d cannot contact the daemon to retrieve
  104.      information.  The daemon may have died or may not have been able to set
  105.      up its IPC.
  106.  
  107.      "Giving up on fetching environmental information" is logged if _s_y_s_c_t_l_r_d
  108.      fails to retrieve environment information 20 times in succession.  Non-
  109.      daemon invocations cannot retrieve information after this happens.
  110.  
  111.      "Overtemp alarm!" is printed to standard error when the system controller
  112.      sends an overtemp message.  This system is shut down automatically at
  113.      this point, syncing disks if graceful powerdown is active.
  114.  
  115.      "Keyswitch off!" is printed to standard error when the key is switched
  116.      off with _s_y_s_c_t_l_r_d running.  This system is shut down, syncing disks if
  117.      graceful powerdown is active.
  118.  
  119.      "Blower failure!" is printed to standard error if the system controller
  120.      detects a failure in one of the system's fans.  The system is powered-
  121.      down immediately.
  122.  
  123.      "Voltage out of tolerance!" is logged if the system controller detects a
  124.      voltage that is out of tolerance but not yet dangerous to the system.
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ssssyyyyssssccccttttllllrrrrdddd((((1111MMMM))))                                                      ssssyyyyssssccccttttllllrrrrdddd((((1111MMMM))))
  137.  
  138.  
  139.  
  140.      "Firmware compensating for blower RPM problem" is logged if the system
  141.      controller must compensate for a blower speed problem by requesting a
  142.      higher blower speed.
  143.  
  144.      "System controller firmware reset" is logged if the system controller
  145.      firmware detects an internal error and resets itself.  This message is
  146.      only indicative of a problem if it is logged repeatedly.
  147.  
  148.      "COP timer reset error!" is logged if the system controller internal
  149.      timer detects hung firmware.  Again, this message is only indicative of a
  150.      problem if it is logged repeatedly.
  151.  
  152.      "System controller crystal oscillator failed!" is logged if the system
  153.      controller detects a problem with its own oscillator.
  154.  
  155.  
  156.      The system controller will send a warning message when it measures an RPM
  157.      higher than the upper tolerance.  Normally this message is sent
  158.      immediately after the system controller powers up (this is only for the
  159.      systems that have the 2700 RPM blower installed).  Sometimes, the blower
  160.      sends out bad RPM data.  The measurement data shows RPM values > 28000
  161.      RPM.  In cases such as these, it has been determined that the tach pulse
  162.      from the blower has noise on it, which causes these incorrect high
  163.      readings.  Some blower(s) checked were actually spinning near 1400 RPM
  164.      when they were reporting an RPM value of 27K.  Now, the system controller
  165.      monitors for this condition and if a reading is posted by the system
  166.      controller > 3000 RPM, a notification message will be posted as a warning
  167.      in both the SYSLOG and on the console at the first occurrence of such an
  168.      event and at intervals of one hour thereafter (if the condition
  169.      persists). Please contact SGI technical support in the event that you
  170.      constantly receive such a message from the system controller.
  171.  
  172.      Note: running the system controller daemon with verbose mode on (-v) will
  173.      generate a large amount of output in the system logfile and should only
  174.      be used when debugging hardware configurations.
  175.  
  176.  
  177.  
  178.  
  179. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  180.      syslog(3C), sysctlr(7M).
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.